Create Business Object
Description
Ivanti Service Manager: Create Business Object step, creates a business object record in Ivanti Service Manager.
Limitation The service request business object record cannot be created using this plugin step since there is a different API endpoint provided to create service request.
References
- Documentation for creating an API Key:
https://help.ivanti.com/ht/help/en_US/ISM/2021/admin/Content/Configure/API/Using-REST-API-Key.htm - API documentation:
https://help.ivanti.com/ht/help/en_US/ISM/2021/admin/Content/Configure/API/Create-a-Business-Object.htm
Sample
{"Category":"Compute","CreatedBy":"Admin","Description":"Test","Owner":"Andrew I. Smythe","OwnerTeam":”Application Development”,"TypeOfChange":”minor”,"Subject:”Test Record”}
Configurations
| No. | Field Name | Description |
|---|---|---|
| 1 | Step name | Name of the step as it appears in the workflow workspace. This name has to be unique in a single workflow. |
| Connection | ||
| 2 | Tenant URL | Tenant URL of Ivanti Service Manager instance. The data type is String. This field is mandatory. |
| 3 | Accept value as variable/static | Leave checkbox unchecked to accept API Key value from a field in the previous steps of the stream using a drop down list. Else enable checkbox for API Key field to appear as Text box. |
| 4 | API Key | Specify or select API Key generated for the tenant. If checkbox above is enabled API Key field appears as Text box and accepts static values or variables. Else if checkbox above is disabled API Key field appears as a drop down containing values from previous steps to select from. The data type is String. This field is mandatory. |
| Input Fields | ||
| 1 | Business Object | Specify the internal name of the Business Object for which record is to be created. The data type is String. This field is mandatory. Note: Locate the internal name using the following steps: i. Click on Settings icon at the right uppermost corner. ii. Select Business Objects under Build option. iii. In the Find box, type the display name of the Business Object and you can see the internal name enclosed in the bracket just under Display Name. |
| 2 | Accept Fields As JSON | Select the checkbox, to use the JSON field as an input to build JSON. If it is not selected, use the table input to build the JSON. |
| 3 | JSON | Select the JSON in a valid format to create a record. For sample JSON, see Sample. Note: This field is available only if Accept Fields As JSON checkbox is selected. If this field is available then it is a mandatory field. |
| Table Fields | The table fields are available only if Accept Fields As JSON checkbox is not selected. | |
| 1 | Variable Field Name | Select the field name as a field or variable. |
| 2 | Static Field Name | Select the fields associated with the business object. |
| 3 | Field Value | Valid values for the field associated with the field name. |
| Output Fields: | ||
| 1 | Rec ID | Specify the output field to hold the Rec ID of the record created on successful plugin execution. |